home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / datatypes / reko.datatype / reko.datatype.guide (.txt) < prev    next >
Amigaguide Document  |  1996-04-07  |  8KB  |  168 lines
  1. @DATABASE "reko.datatype.guide"
  2. @$VER: reko.datatype.guide 39.2 (22.1.95)
  3. @AUTHOR "Arthur Pijpers"
  4. @NODE Main "reko.datatype Documentation"
  5. @{B}Table of Contents@{UB}
  6. @{" Introduction                           " link Introduction}
  7. @{" Requirements                           " link Requirements}
  8. @{" How to Install                         " link Installation}
  9. @{" What is a REKO Cardset ?               " link REKO }
  10. @{" What is a datatype?                    " link Datatypes}
  11. @{" Implementation Details (Release Notes) " link Implementation}
  12. @{" Revision history                       " link History}
  13. @{" Bugs                                   " link Bugs}
  14. @{" Acknowledgements                       " link Acknowledgements}
  15. @{" Author                                 " link Author}
  16. @ENDNODE
  17. @NODE Introduction
  18. @{B}Introduction@{UB}
  19. This is V39.2 of the @{"REKO" link REKO} @{"datatype" link Datatypes}. The version information can be verified
  20. by using the AmigaDOS @{B}version@{UB} command on the datatype file
  21. SYS:classes/datatypes/reko.datatype after installation.
  22. Once installed, the REKO datatype means that any datatype-aware programs can
  23. read @{"REKO Cardset" link REKO} files.
  24. The REKO datatype is freely distributable, but you may not charge for it,
  25. other than for reasonable media and distribution costs such as those charged
  26. by Fred Fish and other reputable PD libraries.
  27. The REKO datatype can be distributed as part of a datatype collection, but
  28. then you have to supply both the 68000 and the 68020 version.
  29. @ENDNODE
  30. @NODE Requirements
  31. @{B}Requirements@{UB}
  32. Datatypes were introduced with Workbench 3.0, so the main requirement is
  33. that you have this version of the OS. Presumably, any future versions of the
  34. OS will also support them.
  35. Do not try to install the datatype if you are using an OS older than 3.0
  36. (i.e. 1.3, 2.04, or 2.1).  The correct directories do not exist, and nothing
  37. will work even if you create them.
  38. When you use the datatype on a computer without the AGA chipset, then 
  39. pictures with more than 16 colours are automatically dithered to the maximum
  40. number of available colours, unless you have a graphical card added. The
  41. HAM and HAM8 cardsets need AGA or AGA emulation to be displayed correctly.
  42. @ENDNODE
  43. @NODE Installation
  44. @{B}How to Install@{UB}
  45. Installation can be done in one of two ways:
  46. 1) Using Installer
  47. 2) Manual Installation
  48. If you have a copy of Installer, you can simply double click on the
  49. reko.datatype.install icon and follow the onscreen instructions. The
  50. Installer script follows the manual sequence below, so you are advised to
  51. read it quickly so that you know what to expect.
  52. If you do not have Installer, (which is strange, because you have
  53. Workbench 3), then follow the procedure below:
  54. 1) Copy the file reko.datatype.68000 or reko.datatype.68020 to the directory
  55. SYS:classes/datatypes and rename it to reko.datatype (SYS: is a logical name
  56. for the disk you boot from).  You can perform the copy either from the
  57. Workbench or the Shell. Use the 68020 version only on Amigas with a 68020
  58. processor or higher.
  59. 2) Decide whether you want the datatype to be permanently enabled, or
  60. manually run whenever you want to use it.  Proceed to step 3 for a
  61. permanently enabled installation, otherwise proceed to step 4.
  62. 3) Copy the file "REKO Cardset" to the directory DEVS:Datatypes (DEVS: is a
  63. logical directory on the disk you boot from.  It is the same as the DEVS
  64. drawer on the boot disk).  If using the Shell, you will also have to
  65. manually copy the icon file "REKO Cardset.info".  When you reboot your system,
  66. the REKO datatype will be avaliable for use.
  67. 4) Copy the file "REKO Cardset" to the directory SYS:Storage/Datatypes. If
  68. using the Shell, you will also have to manually copy the icon file
  69. "REKO Cardset.info".
  70. The REKO datatype will not be available until you double click on the
  71. "REKO Cardset" icon, at which point it will remain installed until a reboot.
  72. This completes installation.
  73. @ENDNODE
  74. @NODE REKO
  75. @{B}What is a REKO Cardset ?@{UB}
  76. A REKO Cardset is a set of cards that is used in the program
  77. Klondike Deluxe AGA from @{"REKO-Productions" link REKO-Productions}.
  78. @ENDNODE
  79. @NODE Datatypes
  80. @{B}What is a Datatype?@{UB}
  81. Datatypes were introduced with Workbench 3.0, and provide a way for
  82. applications to read data files without having to learn all the messy
  83. details about how the data in the files are stored.
  84. As an example, consider storing pictures on computer.  As Amiga owners, we
  85. are relatively lucky in that all images are stored using the IFF ILBM
  86. format.  Other computers have a bewildering array of incompatible formats,
  87. and there exist commercial packages with the sole purpose of converting
  88. images between them.
  89. If I wanted to write a paint program, it would certainly be more useful if
  90. it could read and maybe write out images in some of these other formats.
  91. However, implementing such feature would be a bit of a nightmare, as I would
  92. have to obtain the specifications of these formats, plus some test images,
  93. and write (and support) a significant amount of code to read and write these
  94. various formats.
  95. A datatype is a little program that performs this conversion for me, and
  96. completely hides all the messy implementation details about what file
  97. headers exist, how they are structured, etc.  My application can open the
  98. datatypes library, pass a file to it and ask if it recognises the format.
  99. The datatypes library has a look at the file, and then consults its list of
  100. installed datatypes to see if any of them recognise it.  It then comes back
  101. to the application with a reply saying "Yup, its a REKO Cardset".
  102. My application can then ask for the data to be read in, and after a short
  103. while the library will return the information in an Amiga standard format,
  104. in this case, an IFF image.  Of course, someone has to write the datatype,
  105. but once written and installed, any other program that uses datatypes can
  106. take advantage of it at no extra cost or expense.
  107. This datatype decodes REKO Cardsets, and any application that wishes to read
  108. this format of images can do so without having to know anything about them.
  109. @ENDNODE
  110. @NODE Implementation
  111. @{B}Implementation Details (Release Notes)@{UB}
  112. These are the release notes for V39.2 of the REKO datatype.
  113. This implementation will decode @{"REKO Cardsets" link REKO} files from
  114. Klondike Deluxe AGA and Klondike Deluxe AGA II. All types of cardsets
  115. from 4 to 256 colours, including HAM and HAM8, are supported. Even cardsets
  116. with sizes other then 88 * 130 are supported, as long as the width is a
  117. multiple of 8, but this feature has not been implemented in Klondike, so
  118. you'll probably never need this.
  119. There are no special Klondike III cardsets.
  120. @ENDNODE
  121. @NODE History
  122. @{B}Revision History@{UB}
  123. Version 1.0 released 15-6-1994
  124.  - First release
  125. Version 39.1 only released local
  126.  - Arrangement of extra cards has been changed a little, to show the
  127.    bottom cards 4 in a row with version II sets.
  128.  - Only 1 space between cards in y-direction to save 'some' chip memory.
  129.  - Version changed to 39.1 to show it needs 3.0.
  130. Version 39.2 released 22-1-1995
  131.  - Arrangement changed again.
  132. @ENDNODE
  133. @NODE Acknowledgements
  134. @{B}Acknowledgements@{UB}
  135. REKO datatype needs the cardsets from the program Klondike Deluxe AGA from
  136. @{"REKO-Productions" link REKO-Productions}.
  137. REKO datatype is based on Sun datatype, also written by me.
  138. This AmigaGuide
  139.  file and the Installer script have been copied from the
  140. JPEG.datatype by Steve Goddard and have been adapted to the REKO datatype.
  141. REKO datatype was compiled using SAS/C V6.51
  142. @ENDNODE
  143. @NODE Bugs
  144. @{B}Bugs@{UB}
  145. When using the datatype in combination with a Picasso II card, there seems
  146. to be a problem. The computer can crash. I can't find the problem.
  147. @ENDNODE
  148. @NODE Author
  149. @{B}Author@{UB}
  150. Please feel free to contact me at:
  151. Arthur Pijpers
  152. 2e Scheepvaartstraat 24
  153. 3151 NP Hoek van Holland
  154. The Netherlands
  155. Usenet  : arthurp@grafix.xs4all.nl
  156. FidoNet :  2:286/407.37
  157. AMYNet  : 39:153/201.37
  158. NLANet  : 14:101/200.37
  159. @ENDNODE
  160. @NODE REKO-Productions
  161. @{B}REKO-Productions@{UB}
  162. REKO PRODUCTIONS                  or REKO PRODUCTIONS
  163. p/a Remy Nusteling                   p/a Koos Roodbol
  164. Krommedijk 145                       Hoekkamp 30
  165. 3312 LC Dordrecht                    3343 CJ H.I.Ambacht
  166. The Netherlands                      The Netherlands
  167. @ENDNODE
  168.